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(57) ABSTRACT 


A system, method and computer-readable storage devices for 
providing a climate data analytic services application pro- 
gramming interface distribution package. The example sys- 
tem can provide various components. The system provides a 
climate data analytic services application programming inter- 
face library that enables software applications running on a 
client device to invoke the capabilities of a climate data ana- 
lytic service. The system provides a command-line interface 
that provides a means of interacting with a climate data ana- 
lytic service by issuing commands directly to the system’s 
server interface. The system provides sample programs that 
call on the capabilities of the application programming inter- 
face library and can be used as templates for the construction 
of new client applications. The system can also provide test 
utilities, build utilities, service integration utilities, and docu- 
mentation. 
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1 
SYSTEM AND METHOD FOR PROVIDING A 
CLIMATE DATA ANALYTIC SERVICES 
APPLICATION PROGRAMMING INTERFACE 
DISTRIBUTION PACKAGE 


BACKGROUND 


1. Technical Field 

The present disclosure relates to providing access to cli- 
mate data and more specifically to providing a distribution 
package whereby end users gain access to a climate data 
analytic services API, program samples, build utilities, and 
documentation. 

2. Introduction 

Climate models generate data that are of great value to 
society. Climate model outputs include retrospective analyses 
that model the historical state of the climate, estimates of 
current climate conditions, and projections of future climate 
conditions. Offering climate data analytics as a service makes 
it easier to access climate model data and perform data analy- 
ses where the data are stored. The capabilities of a climate 
data analytics service can be made available to client devices 
through an application programming interface. Currently, 
however, the ability of end users, applications, climate 
researchers, or members of the public to gain meaningful 
access to climate data analytic services is limited. The current 
technologies are deficient because there exists no effective 
means for gaining access to the libraries, utilities, and docu- 
mentation that include an application programming interface. 
What is needed is an improved approach that makes it easier 
to access the capabilities of a climate data analytic services 
application programming interface. 


BRIEF DESCRIPTION OF THE DRAWINGS 


FIG. 1 illustrates an example climate data analytic services 

application programming interface distribution package; 
FIG. 2 illustrates an example method embodiment; and 
FIG. 3 illustrates an example system embodiment. 


DETAILED DESCRIPTION 


A system, method and computer-readable storage devices 
are disclosed which deliver a climate data analytic services 
application programming interface to the end user. The cli- 
mate data analytic services (CDS) application programming 
interface (API) distribution package provides an example 
embodiment of a system through which users can acquire the 
tools necessary to install and use the CDS API on a client 
device. Various modifications and changes may be made to 
this embodiment without departing from the broader spirit 
and scope of this disclosure. 

FIG. 1 is a diagram showing an example CDS API distri- 
bution package. The example package can includea CDS API 
101, a command-line interface (CLI) 102, sample programs 
103, test utilities 104, build utilities 105, service integration 
utilities 106, and documentation 107. The CDS API 101 itself 
is a programming library containing basic and extended utili- 
ties and an API interface. The API interface can include an 
adapter module that maps the API’s programming library 
utilities to the specific capabilities of a new service or legacy 
system, and a representational state transfer (REST) module 
that communicatively links the adapter module to a new ser- 
vice or legacy system Web service interface. 

The command line interpreter 102 is a software application 
that enables users to interact directly with a climate data 
analytic system’s interface. The CLI draws on the function- 
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ality of the CDS API programming library. In one embodi- 
ment, the CDS API supports a climate data analytics system 
including a MERRA analytic service (MAS) and a persis- 
tence service (PS). The distribution package provides sample 
programs 103 that demonstrate how a client software appli- 
cation can make use of the API libraries to access these 
services. In addition, the distribution package provides test 
utilities 104 that evaluate the robustness of the API runtime 
environment and libraries. As new services become available, 
the distribution package can be extended with sample pro- 
grams and test routines for the new services. Build utilities 
105 enable the end user to install and configure the API 
environment. 

One goal for the distribution package is to make it easy for 
end users to install the CDS API and build CDS API-compli- 
ant software applications that use the capabilities afforded by 
systems that deliver climate data analytics as a service. An 
important complementary goal is to provide the tools neces- 
sary to integrate new services or legacy systems into the CDS 
API framework. To that end, the distribution package also 
provides service integration utilities 106 including templates 
for building CDS API-compliant interfaces to these systems. 

Making a new service or legacy system accessible through 
the CDS API can include building an adapter module that 
maps the functionalities of the new service or legacy system 
to utilities in the API’s programming library. The service 
integration utilities provide the tools and templates to guide 
the construction of such modules. In addition, a collection of 
pre-built adapter modules for commonly used systems, 
including the Earth System Grid Federation (ESGF), Open- 
Source Project for a Network Data Access Protocol 
(OpenDAP) services, and Open Geographic Consortium 
(OGC) Web Processing Service (WPS) services, are provided 
in the distribution package. 

Finally, the CDS API distribution package can include all 
the documentation 107 needed to install, configure, test, and 
use the CDS API. The distribution package can be down- 
loaded to a client device as an archive, such as a .zip file or 
a .tar file. 

Having disclosed some basic system components and con- 
cepts, the disclosure now turns to the exemplary method 
embodiment shown in FIG. 2. For the sake of clarity, the 
method is described in terms of an exemplary system 100 as 
shown in FIG. 1 configured to practice the method. The steps 
outlined herein are exemplary and can be implemented in any 
combination thereof, including combinations that exclude, 
add, or modify certain steps. 

A system 100 configured according to this disclosure can 
provide a climate data analytic services application program- 
ming interface distribution package. The system can include 
a climate data analytic services application programming 
interface (API) library that enables software applications run- 
ning on a client device to invoke the capabilities of a climate 
data analytic service (202). 

The system can include a command-line interface that 
provides a means of interacting with a climate data analytic 
service by issuing commands directly to the system’s server 
interface (204). The system can include sample programs that 
call on the capabilities of the application programming inter- 
face library and can be used as templates for the construction 
of new client applications. The application programming 
interface library can be a set of Python programming lan- 
guage files containing the source code necessary to build and 
execute client-side applications. The sample programs can 
include a Python programming language application that 
demonstrates the use of the climate data analytic services 
application programming interface to automate data gather- 


US 9,411,569 B1 


3 


ing from a climate data analytics service using the basic 
utilities of the service, a Python programming language appli- 
cation that demonstrates the use of the climate data analytic 
services application programming interface to automate data 
gathering from a climate data analytics service using the 
extended utilities of the service, and a Python programming 
language application that demonstrates the use of the climate 
data analytic services application programming interface to 
store a data object in a persistence service then add metadata, 
search, and download the object using the basic utilities of the 
persistence service. The API can communicate with a climate 
data analytics system’s Web service interface through Inter- 
national Organization for Standards (ISO) Open Archival 
Information System (OATS) Reference Model-based uni- 
form resource locators that include an ingest endpoint a gen- 
eral form, a query endpoint of a general form>, an order 
endpoint of the general form a download endpoint of a gen- 
eral form>, an execute endpoint of a general form>, , and a 
status endpoint of a general form. 

The system can include test utilities that evaluate the 
robustness and performance of an installed client-side appli- 
cation programming interface environment (206), and build 
utilities that install the application programming interface 
library and create the client-side run-time environment 
required by the library. The build utilities can be tools such as 
Make, Ant, and Maven, which are trademarks of their respec- 
tive owners. The test utilities can include a MERRA Analytic 
Services robustness test that exercises the basic utility meth- 
ods of the service over various combinations of MERRA 
collections and variables, a persistence service robustness test 
that exercises the basic utility methods of the service with 
various combinations of operations, and a comprehensive 
system robustness test that exercises all methods of all ser- 
vices supported by the climate data analytic services applica- 
tion programming interface. 

The system can include service integration utilities that 
provide templates that can be used to build an application 
programming interface-compliant service interface to a new 
service and a collection of pre-built integration interfaces for 
commonly used services (208). The service integration util1i- 
ties can include specific adaptor modules for ESGF, 
OpenDAP services, and WPS services. The service integra- 
tion library can include an adapter module that maps the 
API’s programming library utilities to the specific capabili- 
ties of a new service or legacy system, and a REST module 
that communicatively links the adapter module to a new ser- 
vice or legacy system Web service interface. The adapter 
module can map climate data analytic service requests based 
on OAIS Reference Model data flow categories to various 
capabilities supported by the API’s programming library. The 
capabilities of the adapter module can include ingest capa- 
bilities that input data objects to a service, query capabilities 
that retrieve metadata relating to data objects in a service, 
order capabilities that dynamically create data objects in a 
service, download capabilities that retrieve data objects from 
a service, execute capabilities that initiate service-definable 
operations, and status capabilities that check the progress of 
an order operation. The adapter and REST module templates 
can be made up of general software subroutine templates 
written in the Java, Python, and PHP programming lan- 
guages. Java, Python, and PHP are trademarks of their respec- 
tive owners. 

The system can provide documentation describing the 
organization of the distribution package and how an end-user 
installs and uses the climate data analytic services application 
programming interface (210). The documentation can 
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include, for example, a readme file that contains detailed 
configuration, deployment, and testing instructions. 

Various embodiments of the disclosure are described in 
detail below. While specific implementations are described, it 
should be understood that this is done for illustration pur- 
poses only. Other components and configurations may be 
used without parting from the spirit and scope of the disclo- 
sure. 

With reference to FIG. 3, an exemplary system and/or 
computing device 300 includes a processing unit (CPU or 
processor) 320 and a system bus 310 that couples various 
system components including the system memory 330 such 
as read only memory (ROM) 340 and random access memory 
(RAM) 350 to the processor 320. The system 300 can include 
a cache 322 of high-speed memory connected directly with, 
in close proximity to, or integrated as part of the processor 
320. The system 300 copies data from the memory 330 and/or 
the storage device 360 to the cache 322 for quick access by the 
processor 320. In this way, the cache provides a performance 
boost that avoids processor 320 delays while waiting for data. 
These and other modules can control or be configured to 
control the processor 320 to perform various operations or 
actions. Other system memory 330 may be available for use 
as well. The memory 330 can include multiple different types 
of memory with different performance characteristics. It can 
be appreciated that the disclosure may operate on a comput- 
ing device 300 with more than one processor 320 or on a 
group or cluster of computing devices networked together to 
provide greater processing capability. The processor 320 can 
include any general purpose processor and a hardware mod- 
ule or software module, such as module 1 362, module 2 364, 
and module 3 366 stored in storage device 360, configured to 
control the processor 320 as well as a special-purpose pro- 
cessor where software instructions are incorporated into the 
processor. The processor 320 may be a self-contained com- 
puting system, containing multiple cores or processors, a bus, 
memory controller, cache, etc. A multi-core processor may be 
symmetric or asymmetric. The processor 320 can include 
multiple processors, such as a system having multiple, physi- 
cally separate processors in different sockets, or a system 
having multiple processor cores on a single physical chip. 
Sunilarly, the processor 320 can include multiple distributed 
processors located in multiple separate computing devices, 
but working together such as via a communications network. 
Multiple processors or processor cores can share resources 
such as memory 330 or the cache 322, or can operate using 
independent resources. The processor 320 can include one or 
more of a state machine, an application specific integrated 
circuit (ASIC), or a programmable gate array (PGA) includ- 
ing a field PGA. 

The system bus 310 may be any of several types of bus 
structures including a memory bus or memory controller, a 
peripheral bus, and a local bus using any of a variety of bus 
architectures. A basic input/output (BIOS) stored in ROM 
340 or the like, may provide the basic routine that helps to 
transfer information between elements within the computing 
device 300, such as during start-up. The computing device 
300 further includes storage devices 360 or computer-read- 
able storage media such as a hard disk drive, a magnetic disk 
drive, an optical disk drive, tape drive, solid-state drive, RAM 
drive, removable storage devices, a redundant array of inex- 
pensive disks (RAID), hybrid storage device, or the like. The 
storage device 360 can include software modules 362, 364, 
366 for controlling the processor 320. The system 300 can 
include other hardware or software modules. The storage 
device 360 is connected to the system bus 310 by a drive 
interface. The drives and the associated computer-readable 
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storage devices provide nonvolatile storage of computer- 
readable instructions, data structures, program modules and 
other data for the computing device 300. In one aspect, a 
hardware module that performs a particular function includes 
the software component stored in a tangible computer-read- 
able storage device in connection with the necessary hard- 
ware components, such as the processor 320, bus 310, display 
370, and so forth, to carry out a particular function. In another 
aspect, the system can use a processor and computer-readable 
storage device to store instructions which, when executed by 
the processor, cause the processor to perform operations, a 
method or other specific actions. The basic components and 
appropriate variations can be modified depending on the type 
of device, such as whether the device 300 is a small, handheld 
computing device, a desktop computer, or a computer server. 
When the processor 320 executes instructions to perform 
“operations”, the processor 320 can perform the operations 
directly and/or facilitate, direct, or cooperate with another 
device or component to perform the operations. 

Although the exemplary embodiment(s) described herein 
employs the hard disk 360, other types of computer-readable 
storage devices which can store data that are accessible by a 
computer, such as magnetic cassettes, flash memory cards, 
digital versatile disks (DVDs), cartridges, random access 
memories (RAMs) 350, read only memory (ROM) 340, a 
cable containing a bit stream and the like, may also be used in 
the exemplary operating environment. Tangible computer- 
readable storage media, computer-readable storage devices, 
or computer-readable memory devices, expressly exclude 
media such as transitory waves, energy, carrier signals, elec- 
tromagnetic waves, and signals per se. 

To enable user interaction with the computing device 300, 
an input device 390 represents any number of input mecha- 
nisms, such as a microphone for speech, a touch-sensitive 
screen for gesture or graphical input, keyboard, mouse, 
motion input, speech and so forth. An output device 370 can 
also be one or more of a number of output mechanisms known 
to those of skill in the art. In some instances, multimodal 
systems enable a user to provide multiple types of input to 
communicate with the computing device 300. The commu- 
nications interface 380 generally governs and manages the 
user input and system output. There is no restriction on oper- 
ating on any particular hardware arrangement and therefore 
the basic hardware depicted may easily be substituted for 
improved hardware or firmware arrangements as they are 
developed. 

For clarity of explanation, the illustrative system embodi- 
ment is presented as including individual functional blocks 
including functional blocks labeled as a “processor” or pro- 
cessor 320. The functions these blocks represent may be 
provided through the use of either shared or dedicated hard- 
ware, including, but not limited to, hardware capable of 
executing software and hardware, such as a processor 320, 
that is purpose-built to operate as an equivalent to software 
executing on a general purpose processor. For example the 
functions of one or more processors presented in FIG. 3 may 
be provided by a single shared processor or multiple proces- 
sors. (Use of the term “processor” should not be construed to 
refer exclusively to hardware capable of executing software.) 
Illustrative embodiments may include microprocessor and/or 
digital signal processor (DSP) hardware, read-only memory 
(ROM) 340 for storing software performing the operations 
described below, and random access memory (RAM) 350 for 
storing results. Very large scale integration (VLSI) hardware 
embodiments, as well as custom VLSI circuitry in combina- 
tion with a general purpose DSP circuit, may also be pro- 
vided. 
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The logical operations of the various embodiments are 
implemented as: (1) a sequence of computer implemented 
steps, operations, or procedures running on a programmable 
circuit within a general use computer, (2) a sequence of com- 
puter implemented steps, operations, or procedures running 
on a specific-use programmable circuit; and/or (3) intercon- 
nected machine modules or program engines within the pro- 
grammable circuits. The system 300 shown in FIG. 3 can 
practice all or part of the recited methods, can be a part of the 
recited systems, and/or can operate according to instructions 
in the recited tangible computer-readable storage devices. 
Such logical operations can be implemented as modules con- 
figured to control the processor 320 to perform particular 
functions according to the programming of the module. For 
example, FIG. 3 illustrates three modules Mod1 362, Mod2 
364 and Mod3 366 which are modules configured to control 
the processor 320. These modules may be stored on the stor- 
age device 360 and loaded into RAM 350 or memory 330 at 
runtime or may be stored in other computer-readable memory 
locations. 

One or more parts of the example computing device 300, 
up to and including the entire computing device 300, can be 
virtualized. For example, a virtual processor can bea software 
object that executes according to a particular instruction set, 
even when a physical processor of the same type as the virtual 
processor is unavailable. A virtualization layer or a virtual 
“host” can enable virtualized components of one or more 
different computing devices or device types by translating 
virtualized operations to actual operations. Ultimately how- 
ever, virtualized hardware of every type is implemented or 
executed by some underlying physical hardware. Thus, a 
virtualization compute layer can operate on top of a physical 
compute layer. The virtualization compute layer can include 
one or more of a virtual machine, an overlay network, a 
hypervisor, virtual switching, and any other virtualization 
application. 

The processor 320 can include all types of processors dis- 
closed herein, including a virtual processor. However, when 
referring to a virtual processor, the processor 320 includes the 
software components associated with executing the virtual 
processor in a virtualization layer and underlying hardware 
necessary to execute the virtualization layer. The system 300 
can include a physical or virtual processor 320 that receive 
instructions stored in a computer-readable storage device, 
which cause the processor 320 to perform certain operations. 
When referring to a virtual processor 320, the system also 
includes the underlying physical hardware executing the vir- 
tual processor 320. 

Embodiments within the scope of the present disclosure 
may also include tangible and/or non-transitory computer- 
readable storage devices for carrying or having computer- 
executable instructions or data structures stored thereon. 
Such tangible computer-readable storage devices can be any 
available device that can be accessed by a general purpose or 
special purpose computer, including the functional design of 
any special purpose processor as described above. By way of 
example, and not limitation, such tangible computer-readable 
devices can include RAM, ROM, EEPROM, CD-ROM or 
other optical disk storage, magnetic disk storage or other 
magnetic storage devices, or any other device which can be 
used to carry or store desired program code in the form of 
computer-executable instructions, data structures, or proces- 
sor chip design. When information or instructions are pro- 
vided via a network or another communications connection 
(either hardwired, wireless, or combination thereof) to acom- 
puter, the computer properly views the connection as a com- 
puter-readable medium. Thus, any such connection is prop- 
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erly termed a computer-readable medium. Combinations of 
the above should also be included within the scope of the 
computer-readable storage devices. 

Computer-executable instructions include, for example, 
instructions and data which cause a general purpose com- 
puter, special purpose computer, or special purpose process- 
ing device to perform a certain function or group of functions. 
Computer-executable instructions also include program 
modules that are executed by computers in stand-alone or 
network environments. Generally, program modules include 
routines, programs, components, data structures, objects, and 
the functions inherent in the design of special-purpose pro- 
cessors, etc. that perform particular tasks or implement par- 
ticular abstract data types. Computer-executable instructions, 
associated data structures, and program modules represent 
examples of the program code means for executing steps of 
the methods disclosed herein. The particular sequence of such 
executable instructions or associated data structures repre- 
sents examples of corresponding acts for implementing the 
functions described in such steps. 

Other embodiments of the disclosure may be practiced in 
network computing environments with many types of com- 
puter system configurations, including personal computers, 
hand-held devices, multi-processor systems, microprocessor- 
based or programmable consumer electronics, network PCs, 
minicomputers, mainframe computers, and the like. Embodi- 
ments may also be practiced in distributed computing envi- 
ronments where tasks are performed by local and remote 
processing devices that are linked (either by hardwired links, 
wireless links, or by a combination thereof) through a com- 
munications network. In a distributed computing environ- 
ment, program modules may be located in both local and 
remote memory storage devices. 

The various embodiments described above are provided by 
way of illustration only and should not be construed to limit 
the scope of the disclosure. For example, the principles herein 
apply generally to climate data, but can also be applied to 
other non-climate data sets. Various modifications and 
changes may be made to the principles described herein with- 
out following the example embodiments and applications 
illustrated and described herein, and without departing from 
the spirit and scope of the disclosure. Claim language reciting 
“at least one of” a set indicates that one member of the set or 
multiple members of the set satisfy the claim. 

We claim: 

1. A system for providing a climate data analytic services 
application programming interface distribution package, the 
system comprising: 

a processor; 

a non-transitory computer-readable storage medium stor- 
ing instructions which, when executed by the processor, 
cause the processor to provide: 

a climate data analytic services application program- 
ming interface library that enables software applica- 
tions running on a client device to invoke capabilities 
of a climate data analytic service; 

acommand-line interface that provides a means of inter- 
acting with a climate data analytic service by issuing 
commands directly to the system’s server interface; 

sample programs that call on the capabilities of an appli- 
cation programming interface library to be used as 
templates for construction of new client applications; 

test utilities that evaluate the robustness and perfor- 
mance of an installed client-side application program- 
ming interface environment; 

build utilities that install the application programming 
interface library and create the client-side run-time 
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environment required by the services application pro- 
gramming interface library; 

service integration utilities that provide templates to be 
used to build an interface to one of a new service or 
legacy system, and a collection of pre-built integra- 
tion interfaces for commonly used systems; and 

documentation describing an organization of the distri- 
bution package and how an end-user installs and uses 
the climate data analytic services application pro- 
gramming interface. 

2. The system of claim 1, wherein the application program- 
ming interface library comprises files containing a source 
code necessary to build and execute client-side applications. 

3. The system of claim 1, wherein the build utilities com- 
prise a plurality of tools. 

4. The system of claim 1, wherein the sample programs 
further comprise: 

an application that demonstrates the use of the climate data 
analytic services application programming interface to 
automate data gathering from a climate data analytics 
service using the basic utilities of the service; 

an application that demonstrates the use of the climate data 
analytic services application programming interface to 
automate data gathering from a climate data analytics 
service using an extended utilities of the service; and 

an application that demonstrates the use of the climate data 
analytic services application programming interface to 
store a data object in a persistence service then add 
metadata, search, and download an object using a basic 
utilities of a persistence service. 

5. The system of claim 1, wherein the test utilities further 

comprise: 

a MERRA Analytic Services robustness test that exercises 
a basic utility methods of the service over various com- 
binations of MERRA collections and variables; 

a persistence service robustness test that exercises the basic 
utility methods of the service with various combinations 
of operations; and 

a comprehensive robustness test that exercises all methods 
of all services supported by the climate data analytic 
services application programming interface. 

6. The system of claim 1, further comprising a service 

integration library further comprises: 

an adapter module that maps the application programming 
interface’s programming library utilities to specific 
capabilities of a new service or legacy system; and 

a representational state transfer module that communica- 
tively links the application programming interface to a 
new service or legacy system Web service interface. 

7. The system of claim 6, wherein the adapter module maps 
service requests based on International Organization for 
Standards Open Archival Information System Reference 
Model data flow categories comprising: 

ingest capabilities that input data objects to a service; 

query capabilities that retrieve metadata relating to data 
objects in a service; 

order capabilities that dynamically create data objects ina 
service; 

download capabilities that retrieve data objects from a 
service; 

execute capabilities that initiate service-definable opera- 
tions; and 

status capabilities that check the progress of an order 
operation. 

8. The system of claim 6, wherein the adapter and repre- 

sentational state transfer modules further comprise general 
templates. 
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9. The system of claim 1, wherein the service integration 
utilities comprise specific adaptor modules for an Earth Sys- 
tem Grid Federation, Open-Source Project for a Network 
Data Access Protocol services, and Open Geographic Con- 
sortium Web Processing Service services. 


10. The system of claim 1, wherein the documentation 
further comprises a readme file that contains detailed con- 
figuration, deployment, and testing instructions. 


11. A method comprising: 


providing, via a processor of a computing device, a climate 
data analytic services application programming inter- 
face library that enables software applications running 
ona client device to invoke capabilities ofa climate data 
analytic service; 


providing a command-line interface that provides a means 
of interacting with a climate data analytic service by 
issuing commands directly to a system’s server inter- 
face; 
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providing sample programs that call on the capabilities of 
the application programming interface library to be used 
as templates for a construction of new client applica- 
tions; 

providing test utilities that evaluate the robustness and 
performance of an installed client-side application pro- 
gramming interface environment; 

providing build utilities that install the application pro- 
gramming interface library and create a client-side run- 
time environment required by the application program- 
ming interface library; 

providing service integration utilities that provide tem- 
plates to be used to build an interface to one of a new 
service or legacy system, and a collection of pre-built 
integration interfaces for commonly used systems; and 

providing documentation describing an organization of a 
distribution package and how an end-user installs and 
uses the climate data analytic services application pro- 
gramming interface. 


* * * * * 


